home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / dev / gcc / ixemsdk.lha / man / cat2 / ioctl.0 < prev    next >
Text File  |  1996-09-01  |  2KB  |  47 lines
  1.  
  2. IOCTL(2)                   UNIX Programmer's Manual                   IOCTL(2)
  3.  
  4. NNAAMMEE
  5.      iiooccttll - control device
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<ssyyss//iiooccttll..hh>>
  9.  
  10.      _i_n_t
  11.      iiooccttll(_i_n_t _d, _u_n_s_i_g_n_e_d _l_o_n_g _r_e_q_u_e_s_t, _c_h_a_r _*_a_r_g_p)
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.      The iiooccttll() function manipulates the underlying device parameters of spe-
  15.      cial files.  In particular, many operating characteristics of character
  16.      special files (e.g. terminals) may be controlled with iiooccttll() requests.
  17.      The argument _d must be an open file descriptor.
  18.  
  19.      An  ioctl _r_e_q_u_e_s_t has encoded in it whether the argument is an ``in'' pa-
  20.      rameter or ``out'' parameter, and the size of the argument _a_r_g_p in bytes.
  21.      Macros and defines used in specifying an ioctl _r_e_q_u_e_s_t are located in the
  22.      file <_s_y_s_/_i_o_c_t_l_._h>.
  23.  
  24. RREETTUURRNN VVAALLUUEESS
  25.      If an error has occurred, a value of -1 is returned and _e_r_r_n_o is set to
  26.      indicate the error.
  27.  
  28. EERRRROORRSS
  29.      IIooccttll() will fail if:
  30.  
  31.      [EBADF]       _d is not a valid descriptor.
  32.  
  33.      [ENOTTY]      _d is not associated with a character special device.
  34.  
  35.      [ENOTTY]      The specified request does not apply to the kind of object
  36.                    that the descriptor _d references.
  37.  
  38.      [EINVAL]      _R_e_q_u_e_s_t or _a_r_g_p is not valid.
  39.  
  40. SSEEEE AALLSSOO
  41.      mt(1),  execve(2),  fcntl(2),  tty(4),  intro(4)
  42.  
  43. HHIISSTTOORRYY
  44.      An iiooccttll() function call appeared in Version 7 AT&T UNIX.
  45.  
  46. 4th Berkeley Distribution      December 11, 1993                             1
  47.